home *** CD-ROM | disk | FTP | other *** search
/ Delphi Developer's Kit 1996 / Delphi Developer's Kit 1996.iso / power / tmapi / readme.txt < prev    next >
Text File  |  1995-12-22  |  3KB  |  65 lines
  1. TMAPISend Delphi Component   6/95
  2. Microsoft Mail 'MAPISendDocuments' Function
  3.  
  4. It is important to read this file as there is no online help included
  5. with this component.  These files are considered freeware, with complete 
  6. source included.
  7.  
  8. If these files MAPISEND.PAS, MAPISEND.DCU, and MAPISEND.DCR are copied 
  9. into your \DELPHI\LIB directory, you can simply install the TMAPISend
  10. component using 'Options' 'Install Components' and specify MAPISEND.PAS.
  11. The MAPISend component is then made available in the 'Sample' section of
  12. your palette.
  13.  
  14. The component itself is actually very simple and is modeled using the 
  15. MAPISENDDocuments function of Microsoft's MAPI.DLL.  There are simple
  16. properties and a single function of 'Execute'.
  17.  
  18. To use the component within your Delphi application, simply click on
  19. the MAPISend component button in your palette, and place it onto your
  20. form.
  21.  
  22. The five properties are as follows:
  23.  
  24. Delimiter:   The single character delimiter which separates filenames
  25.              of those files which are to be attached and their
  26.              corresponding paths.  MUST NOT BE A RESERVED DOS FILENAME
  27.              CHARACTER!  (a semicolon is best)
  28. FileNames:   Names of each of the files to be attached to a MS Mail
  29.              message, separated by the character specified in the 
  30.              'Delimiter' property.  These are the names as you wish them
  31.              to appear in the message. (ie MYFILE.TXT)
  32. FilePaths:   Actual filenames and paths of those files to be attached to
  33.              the MS Mail message, separated by the character specified in
  34.              the 'Delimiter' property.  These are the names and paths of
  35.              the actual files to be attached (ie C:\MYFILES\MYFILE.TXT)
  36. Name:        Name of the component. 
  37. Tag:         Standard tag included in all components.
  38.  
  39. The first three properties may be either defined at design time or run 
  40. time.  Invalid filenames, etc. are handled by the MAPI resource, however
  41. it may be wise to include validity checks before assigning property values
  42. to the TMAPISend component, as it does not include them.  Once they are
  43. defined, (assuming your TMAPISend component's name is MAPISend1) a simple:
  44.  
  45. MAPISend1.Execute;
  46.  
  47. will produce a send mail dialog along with the files you have indicated in
  48. the components properties as attachments.
  49.  
  50. Most importantly, don't forget that in order for it to work properly, 
  51. Microsoft Mail's MAPI.DLL must be in the path and a fully functional
  52. installation of Microsoft Mail must be present.  (This component was
  53. developed on a platform using version 3.0b.  Consult the MS Mail technical
  54. reference for version compatibility.)
  55.  
  56. I have tested this component thoroughly and it seems that there are no
  57. problems, and it is a quick way to mail enable your application.
  58.  
  59. I am no expert on MAPI functions, although I have some experience in 
  60. mail-enabling ObjectPal and Delphi applications.  However, if you have
  61. any questions, feel free to drop me a line.
  62.  
  63. Kevin Savko
  64. 75024,2760
  65.